Inside Macintosh: Mac OS 8 Toolbox Reference /

Chapter 4 - Dialog Manager Reference / Dialog Manager Functions

Creating Alerts /

NoteAlert

CHANGED WITH THE APPEARANCE MANAGER

Displays an alert box with a note icon in its upper-left corner (or, if appropriate for the alert stage, plays an alert sound instead of or in addition to displaying the alert box).

pascal short NoteAlert (
                     short alertID,
                     ModalFilterUPP modalFilter);

alertID

The resource ID of an alert resource and extended alert resource. If the alert resource is missing, the Dialog Manager returns to your application without creating the requested alert.

modalFilter

A universal procedure pointer for a filter function that responds to events not handled by the ModalDialog function. If you set this parameter to nil, the Dialog Manager uses the standard event filter function.

function result

If no alert box is to be drawn at the current alert stage, NoteAlert returns -1; otherwise, it creates and displays the alert box and returns the item number of the control selected by the user; see "Alert Button Constants".

DISCUSSION

The NoteAlert function is the same as the Alert function except that, before drawing the items in the alert box, NoteAlert draws the note icon in the upper-left corner. The note icon has resource ID 1, which you can also specify with the constant noteIcon. By default, the Dialog Manager uses the standard note icon from the System file. You can change this icon by providing your own 'ICON' resource with resource ID 1.

Use a note alert to inform users of a minor mistake that won't have any disastrous consequences if left as is. Usually this type of alert simply offers information, and the user responds by clicking an OK button. Occasionally, a note alert may ask a simple question and provide a choice of responses.

IMPORTANT

Your application should never draw its own default rings or alert icons. Prior to Mac OS 8, the NoteAlert function would only redraw the alert icon and default button ring once and never redraw them on an update event. However, when Appearance is available, alert icons and default rings do redraw when you call NoteAlert.

SEE ALSO

CautionAlert.

StopAlert.

WHEN THE APPEARANCE MANAGER IS NOT AVAILABLE

NoteAlert only reads in the resource ID of an alert resource, not an extended alert resource.